# 1 电子邮件
# 电子邮件软件被称为MUA：Mail User Agent——邮件用户代理。
# Email从MUA发出去，不是直接到达对方电脑，而是发到MTA：Mail Transfer Agent——邮件传输代理，
# 就是那些Email服务提供商，比如网易、新浪等等。例如我们用163.com，所以，Email首先被投递到网易提供的MTA，
# 再由网易的MTA发到对方服务商，也就是新浪的MTA。这个过程中间可能还会经过别的MTA，
# 但是我们不关心具体路线，我们只关心速度.
# MTA会把Email投递到邮件的最终目的地MDA：Mail Delivery Agent——邮件投递代理。
# Email到达MDA后，就静静地躺在新浪的某个服务器上，存放在某个文件或特殊的数据库里，
# 我们将这个长期保存邮件的地方称之为电子邮箱。
# 同普通邮件类似，Email不会直接到达对方的电脑，因为对方电脑不一定开机，开机也不一定联网。
# 对方要取到邮件，必须通过MUA从MDA上把邮件取到自己的电脑上。
# 一封电子邮件的旅程就是：发件人 -> MUA -> MTA -> MTA -> 若干个MTA -> MDA <- MUA <- 收件人
# 要编写程序来发送和接收邮件，本质上就是：1.编写MUA把邮件发到MTA；2.编写MUA从MDA上收邮件。
# 发邮件时，MUA和MTA使用的协议就是SMTP：Simple Mail Transfer Protocol，后面的MTA到另一个MTA也是用SMTP协议。
# 收邮件时，MUA和MDA使用的协议有两种：POP：Post Office Protocol，目前版本是3，俗称POP3；
# IMAP：Internet Message Access Protocol，目前版本是4，优点是不但能取邮件，还可以直接操作MDA上存储的邮件，比如从收件箱移到垃圾箱，等等。
# 邮件客户端软件在发邮件时，会让你先配置SMTP服务器，也就是你要发到哪个MTA上。假设你正在使用163的邮箱，你就不能直接发到新浪的MTA上，因为它只服务新浪的用户，所以，你得填163提供的SMTP服务器地址：smtp.163.com，为了证明你是163的用户，SMTP服务器还要求你填写邮箱地址和邮箱口令，这样，MUA才能正常地把Email通过SMTP协议发送到MTA。
# 类似的，从MDA收邮件时，MDA服务器也要求验证你的邮箱口令，确保不会有人冒充你收取你的邮件，所以，Outlook之类的邮件客户端会要求你填写POP3或IMAP服务器地址、邮箱地址和口令，这样，MUA才能顺利地通过POP或IMAP协议从MDA取到邮件。

# 2. SMTP发送邮件
# SMTP是发送邮件的协议，Python内置对SMTP的支持，可以发送纯文本邮件、HTML邮件以及带附件的邮件。
# Python对SMTP支持有smtplib和email两个模块，email负责构造邮件，smtplib负责发送邮件。
from email.mime.text import MIMEText

# 第一个参数就是邮件正文，第二个参数是MIME的subtype，传入'plain'表示纯文本，最终的MIME就是'text/plain'，最后一定要用utf-8编码保证多语言兼容性。
msg = MIMEText('hello,send by python...', 'plain', 'utf-8')
# 发送
from_addr = input('from: ')
password = input('password: ')
to_addr = input('to:')
# 输入SMTP服务器地址
smtp_server = input('smtp server:')
import smtplib

server = smtplib.SMTP(smtp_server, 25)  # smtp协议默认端口号25
server.set_debuglevel(1)  # 可以打印出和SMTP服务器交互的所有信息
server.login(from_addr, password)
# 可以一次发给多个人,邮件正文是一个str，as_string()把MIMEText对象变成str
server.sendmail(from_addr, [to_addr], msg.as_string())
server.quit()
# 发送成功后,观察会发现下面问题:
# 邮件没有主题；
# 收件人的名字没有显示为友好的名字，比如Mr Green <green@example.com>；
# 明明收到了邮件，却提示不在收件人中。
# 这是因为邮件主题、如何显示发件人、收件人等信息并不是通过SMTP协议发给MTA，而是包含在发给MTA的文本中的，
# 所以，我们必须把From、To和Subject添加到MIMEText中，才是一封完整的邮件：
# 详见email_send_demo.py

# 发送HTML邮件
# 如果我们要发送HTML邮件，而不是普通的纯文本文件怎么办？方法很简单，在构造MIMEText对象时，
# 把HTML字符串传进去，再把第二个参数由plain变为html就可以了：
msg = MIMEText('<html><body><h1>Hello</h1>' +
               '<p>send by <a href="http://www.python.org">Python</a>...</p>' +
               '</body></html>', 'html', 'utf-8')
# 发送附件
# 如果Email中要加上附件怎么办？带附件的邮件可以看做包含若干部分的邮件：文本和各个附件本身，所以，
# 可以构造一个MIMEMultipart对象代表邮件本身，然后往里面加上一个MIMEText作为邮件正文，
# 再继续往里面加上表示附件的MIMEBase对象即可：
# 邮件对象
from email.header import Header
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from basic_demo import email_send_demo
from email import encoders
import os

msg = MIMEMultipart()
msg['From'] = email_send_demo._format_addr('from_pyLJY<%s>' % from_addr)
msg['To'] = email_send_demo._format_addr('to_pyJinYang<%s>' % to_addr)
msg['Subject'] = Header('来自py的问候...', 'utf-8').encode()
# 邮件正文
msg.attach(MIMEText('send with files...', 'plain', 'utf-8'))
# 添加附件就是加上一个MIMEBase,如,从本地读取一个图片
dir_path = os.path.join(".", "file")
file_path = os.path.join(dir_path, '456.jpg')
with open(file_path, 'rb') as f:
    # 设置附件的MIME和文件名
    mime = MIMEBase('image', 'jpeg', filename='456.jpg')
    # 加上必要的头信息
    mime.add_header('Content-Disposition', 'attachment', filename='456.jpg')
    mime.add_header('Content-ID', '<0>')
    mime.add_header('X-Attachment-Id', '0')
    # 把附件的内容读进来
    mime.set_payload((f.read()))
    # 用base64编码
    encoders.encode_base64(mime)
    # 添加到MIMEMultipart
    msg.attach(mime)
# 然后，按正常发送流程把msg（注意类型已变为MIMEMultipart）发送出去，就可以收到带附件的邮件：

# 也可以参考简书上这个文章https://www.jianshu.com/p/abb2d6e91c1f

# 发送图片
# 如果要把一个图片嵌入到邮件正文中怎么做？直接在HTML邮件中链接图片地址行不行？答案是，大部分邮件服务商都会自动屏蔽带有外链的图片，因为不知道这些链接是否指向恶意网站。
# 要把图片嵌入到邮件正文中，我们只需按照发送附件的方式，先把邮件作为附件添加进去，然后，在HTML中通过引用src="cid:0"就可以把附件作为图片嵌入了。如果有多个图片，给它们依次编号，然后引用不同的cid:x即可。
# 把上面代码加入MIMEMultipart的MIMEText从plain改为html，然后在适当的位置引用图片：
# msg.attach(MIMEText('<html><body><h1>Hello</h1>' +
#     '<p><img src="cid:0"></p>' +
#     '</body></html>', 'html', 'utf-8'))


# 同时支持HTML和Plain格式
# 如果我们发送HTML邮件，收件人通过浏览器或者Outlook之类的软件是可以正常浏览邮件内容的，但是，如果收件人使用的设备太古老，查看不了HTML邮件怎么办？
# 办法是在发送HTML的同时再附加一个纯文本，如果收件人无法查看HTML格式的邮件，就可以自动降级查看纯文本邮件。
# 利用MIMEMultipart就可以组合一个HTML和Plain，要注意指定subtype是alternative：
# msg = MIMEMultipart('alternative')
# msg['From'] = ...
# msg['To'] = ...
# msg['Subject'] = ...
# msg.attach(MIMEText('hello', 'plain', 'utf-8'))
# msg.attach(MIMEText('<html><body><h1>Hello</h1></body></html>', 'html', 'utf-8'))
# # 正常发送msg对象...

# 加密SMTP
# 使用标准的25端口连接SMTP服务器时，使用的是明文传输，发送邮件的整个过程可能会被窃听。要更安全地发送邮件，可以加密SMTP会话，实际上就是先创建SSL安全连接，然后再使用SMTP协议发送邮件。
# 某些邮件服务商，例如Gmail，提供的SMTP服务必须要加密传输。我们来看看如何通过Gmail提供的安全SMTP发送邮件。
# 必须知道，Gmail的SMTP端口是587，因此，修改代码如下：
# smtp_server = 'smtp.gmail.com'
# smtp_port = 587
# server = smtplib.SMTP(smtp_server, smtp_port)
# server.starttls()
# # 剩下的代码和前面的一模一样:
# server.set_debuglevel(1)
# ...
# 只需要在创建SMTP对象后，立刻调用starttls()方法，就创建了安全连接。后面的代码和前面的发送邮件代码完全一样。
#
# 如果因为网络问题无法连接Gmail的SMTP服务器，请相信我们的代码是没有问题的，你需要对你的网络设置做必要的调整。


# 3. POP3收取邮件
# 收取邮件就是编写一个MUA作为客户端，从MDA把邮件获取到用户的电脑或者手机上。
# 收取邮件最常用的协议是POP协议，目前版本号是3，俗称POP3。
# Python内置一个poplib模块，实现了POP3协议，可以直接用来收邮件。
# 注意到POP3协议收取的不是一个已经可以阅读的邮件本身，而是邮件的原始文本，这和SMTP协议很像，SMTP发送的也是经过编码后的一大段文本。
# 要把POP3收取的文本变成可以阅读的邮件，还需要用email模块提供的各种类来解析原始文本，变成可阅读的邮件对象。
# 详见email_get_demo.py
# 用Python的poplib模块收取邮件分两步：第一步是用POP3协议把邮件获取到本地，
# 第二步是用email模块把原始邮件解析为Message对象，然后，用适当的形式把邮件内容展示给用户即可。
